v3.1.0

Compare Source

Minor Changes

• 8e9767e: activeType should be initialized from meta['*']
• fec399a: fix type: 'separator', type: 'menu' and item with href not
  respecting order when not all pages specified in _meta file

Patch Changes

• 035fe48: - fix empty dropdown menu when _meta item with type: "menu"
  contains items with local pages
• c002118: - add tests for should respect order for type: "separator",
  type: "menu" and item with href

v3.0.15

Compare Source

Patch Changes

• Updated dependencies [bd498c6]
  • [email protected]

v3.0.14

Compare Source

Patch Changes

• 9794e9e: Fix frontMatter.sidebarTitle didn't affect without
  frontMatter.title set

  now priority for sidebar title is:

  1. title property from _meta file
  2. frontMatter.sidebarTitle
  3. frontMatter.title
  4. formatted with Title based on filename

• Updated dependencies [6454938]

• Updated dependencies [9794e9e]

• Updated dependencies [9794e9e]

  • [email protected]

v3.0.13

Compare Source

Patch Changes

• f1815ac: From an accessibility POV (WCAG G13) there's a need of additional
  visual differentiation factor for hovers. Article achieves this but mdx
  doesn't.

  So changing the mdx link behaviour so on hover the underline disappears.

  • [email protected]

v3.0.12

Compare Source

Patch Changes

• 7e0093f: Fix nextra/locales middleware, redirect to the docs URL relative to
  the /<basePath>.
• Updated dependencies [7e0093f]
  • [email protected]

v3.0.11

Compare Source

Patch Changes

• Updated dependencies [e0a9303]
  • [email protected]

v3.0.10

Compare Source

Patch Changes

• Updated dependencies [31de764]
• Updated dependencies [161d350]
  • [email protected]

v3.0.9

Compare Source

Patch Changes

• Updated dependencies [f9cc160]
  • [email protected]

v3.0.8

Compare Source

Patch Changes

• 72c84eb: add max-md:_overflow-hidden instead of _overflow-hidden when
  hamburger is clicked
• 1530239: hide <summary> marker on Safari
• 210d68a: trigger scrolling when the TOC item is outside the viewport
• bf04f96: add ring-inset for navbar links
  • [email protected]

v3.0.7

Compare Source

Patch Changes

• Updated dependencies [4bbc1fe]
  • [email protected]

v3.0.6

Compare Source

Patch Changes

• [email protected]

v3.0.5

Compare Source

v3.0.4

Compare Source

Patch Changes

• 84fc255: should get right activeType, activeThemeContext even when some
  parent has display: 'hidden'
• 9b6595d: Ensure the jump link behavior is consistent in Markdown.
• f3a5575: add a scrollbar for nav links in the header when they exceed
  available free space
• Updated dependencies [84a8a41]
• Updated dependencies [659b36e]
• Updated dependencies [84fc255]
  • [email protected]

v3.0.3

Compare Source

Patch Changes

• 9d93caf: RTL support for the <Steps> component.
• 5fbce2f: Added golang logo for code blocks.
• Updated dependencies [82fc267]
• Updated dependencies [edc6c29]
• Updated dependencies [9d93caf]
• Updated dependencies [5fbce2f]
  • [email protected]

v3.0.2

Compare Source

Patch Changes

• b6341f7: remove warning
  Watchpack Error (initial scan): Error: ENOTDIR: not a directory, scandir 'path-to-your-node_modules/next/dist/pages/_app.js'

v3.0.1

Compare Source

Patch Changes

• d9d0820: fix unclickable links on mobile
  • [email protected]

v3.0.0

Compare Source

Major Changes

• e7e8e84: show react components, variable interpolation and latex in toc

• c7f03e5: remove toc.headingComponent

• ea1a736: remove next-seo and useNextSeoProps, use head option instead

• c2ad837: update to MDX3

• 148278c: rename tailwind prefix nx- to _ to reduce bundle size

• 919fe97: set "peerDependencies.next": ">=13"

• 47b125d: fix global style conflicts for
  <a>/<button>/<summary>/<input>/[tabindex]:not([tabindex='-1']

• ba30c6c: use render props for className with selected, disabled and
  hover state for <Tab>

• d7d8a3e: new styles for code blocks aka in next.js

• 2872606: remove image prop from <Card> component, image will be showed
  based on truthiness children prop now

  set icon as optional prop

• 63ca28b: Remove support of "_meta.json", use "_meta.{js,jsx,ts,tsx}"
  instead.

• ebe652d: remove sidebar.titleComponent, use JSX for styling separators and
  titles

• eca7535: - remove Steps, Callout, Tabs, Tab, Cards, Card,
  FileTree exports, export them now from nextra/components

  • remove useMDXComponents export, export it now from nextra/mdx
  • set by default sidebar.toggleButton to true

• 128e195: fix React warning, remove PageOpts.toc, use toc prop from
  components.wrapper

• 63ca28b: remove config.serverSideError

• f2dd18d: - rename theme config options

  i18n.text → i18n.name

  banner.text → banner.content

  editLink.text → editLink.content

  footer.text → footer.content

• 198dbcc: use toc with JSX elements for remote content

• 191e6c4: - use shikiji instead of shiki

  • rename useSSG to useData

• 6eb3118: rename primaryHue and primarySaturation theme options to
  color.hue and color.saturation

• c7f03e5: rename pageOpts.headings to toc

• 8c1b9d5: remove <MatchSorterSearch>

Minor Changes

• eb943d0: add theme.topContent and theme.bottomContent

• 0fe55db: add import { useRouter } from 'nextra/hooks' for fetching locale
  and defaultLocale

• c77485e: set default head option as null

• 1dcb91a: export useThemeConfig

• 6ec3241: Add Terraform/Move icon #​2811
  #​2808

• 5a63701: add icons for following languages:

  • GraphQL (graphql)
  • C++ (c++, cpp)
  • C# (csharp, c#, cs)
  • Python (python, py)

  allow disallow mobile word wrap button in code blocks with word-wrap=false
  meta data setting

• a52a869: add frontmatter.sidebarTitle support for setting page label in
  sidebar via frontmatter

• 6ec3241: Make the <Tab> component be crawlable and indexable by search
  engines by default

• b47880d: export useMenu hook

• b776b16: add backgroundColor.light and backgroundColor.dark theme options

• 6070b02: rename frontmatter.sidebar_label to frontmatter.sidebarTitle

• 3043826: add shikiji twoslash

  Demo feature:
  https://nextra-v2-na3obnhub-shuding1.vercel.app/docs/guide/twoslash-support

• 6070b02: move removeLinks function from nextra-theme-docs to
  nextra/remove-links

• 962cea6: allow items: Map for type: 'menu' since object can't guaranty the
  insertion order

• 440ff42: add MathJax support

• 1a97327: keep loading, placeholder and themeSwitch.useOptions default
  theme options only for en lang

Patch Changes

• b045cc3: fix invisible mobile menu after click on hamburger

• eeb4c4c: enable outline: 'none' only for :focus-visible state, to fix
  double ring in Firefox

• 376b895: fixes case when setting disabled: true on the scroll to top button
  prevents scrolling to most top

  scroll to most top in toc element too

• 34e25cd: migrate search to @headlessui/react Combobox

• 73239c4: To ensure consistent horizontal padding, set the default language as
  plaintext for code blocks. This prevents any loss of formatting for code
  blocks without a specified language.

• 57f3963: Remove intersection-observer polyfill

• 2b9b95b: migrate to @headlessui/react v2

• 7457d6b: remove git-url-parse to keep bundle smaller

• 2a3e3e7: Fix first list item in <FileTree> not within permitted parent
  elements

• 6070b02: load flexsearch dynamically to reduce bundle size

• 0b4d43b: Avoid the sidebar collapse having unintended animations when
  sidebar.autoCollapse is set to true.

• 31c2ee7: fix removeLinks when input node is link

• bf963cd: Remove the aria-hidden attribute from scroll-to-top button when it is
  visible

• 829c417: - fix overflow when clicking on <details> with open state

  • fix animation on mobile when clicking on <details> with open state

• cb24790: fix broken export default statement in mdx files

• de56507: fix vertical margin for nested ordered <ol> and unordered <ul>
  lists

• 8c99baf: enhance search input to better support CJK language users

• a8c2196: use dynamic import for loading mermaid

• 0b5cc9d: make nextra compatible with windows

• 7b0b7e9: fix page scroll jump while entering characters in the search input

• 45471df: fix “Scroll to top” is not supposed to be interactable when it is
  hidden.

  display:children doesn't collapse breadcrumbs

  hide external links from pagination

  remove xmlns attribute from icons

• 8ffe2fe: remove focus-visible polyfill

• fe5061b: fix for remote docs

• 6945f38: fix not rendered default <meta name="description" /> and
  <meta property="og:description" />

• 1a634cd: remove explicit ZodError assertion

• ad108ff: use overflow-x-auto instead overflow-x-scroll for <Table>

• 4f0f6b2: Omit ...{:type} inline code annotations from search index #​2922

• 150184b: attach heading anchor id attribute to heading (like Pagefind do)
  and fix heading anchor styles when theme.typesetting: 'article' is set

• 80c9764: ensure zod is removed from production build with /* @​__PURE__ */
  comments

• 9df7f58: Fix nav-links not highlighting on hover in dark mode

• 7bb18e3: Add a generic for themeConfig in NextraThemeLayoutProps to
  improve type inference.

• 9b41180: backToTop is hidden when enabled but when toc.extraContent,
  feedback.content and editLink.component are falsy

• 6f4c83a: fix unclickable links in TOC

  allow passing recmaPlugins in mdxOptions

• f255696: Improve styles for reduced motion preferences

• 9f55bd1: update rehype-pretty-code/shikiji to latest

• d21634d: export getComponents

• 452e5bd: Add <Playground> component

  https://nextra-v2-9x7fp6hti-shud.vercel.app/docs/guide/advanced/playground

• e95faa1: - fixed <summary> lost whitespaces when there is some HTML element
  inside

  • fixed hydration errors and <summary> was not rendered when <details>
    text content follows directly after <summary> element

• ccaf3d4: Add the autoImportThemeStyle option to the Nextra configuration.
  This allows users to import the official Nextra theme CSS into a specific
  cascade layer.

• cee94a6: Consider the navbar height when setting the root margin for the
  active anchor intersection observer

• 2630461: fix
  TypeError: undefined is not iterable (cannot read property Symbol(Symbol.iterator))
  on dev environment when frontMatter.searchable: false

• 217f708: update next-themes

  fix wrong numbering for nested <Steps>

• ca51306: Enhance focus ring style consistency.

• f662237: avoid focus-visible style being cut off by overflow-hidden

• 3c6193d: Remove unnecessary sortPages from server/utils.ts

• 1a97327: Update the backToTop option in the docs theme configuration to
  support i18n

• 799174f: fixed react warning
  Warning: React has detected a change in the order of Hooks called by Body
  when themeConfig.main options is used

• 363b85f: add flex-shrink: 0 for indent in FileTree for <Ident> and svg
  icons in <Folder> and <File>

• 237c345: Make React 18 as minimal requirement

• eb943d0: hardcode flexsearch version to 0.7.31, because package is broken on
  0.7.41

• ad108ff: fix <Bleed> overflows incorrectly in firefox

• 4fb2452: fix invisible mobile menu when layout: "raw" is specified in _meta
  file

• 7faa096: fix visible hidden pages on mobile which set up with
  display: 'hidden'

• 315ca82: remove possible links in toc elements

• a95e745: Fix the line highlighting background-color does not extend to the
  full width of the code block when a scrollbar appears with line numbers.

• 363b85f: fix RangeError: Maximum call stack size exceeded in findSummary
  when child.props.children is undefined

• Updated dependencies [e7e8e84]

• Updated dependencies [7188278]

• Updated dependencies [d1e3e9a]

• Updated dependencies [73239c4]

• Updated dependencies [2b9b95b]

• Updated dependencies [023d37b]

• Updated dependencies [0fe55db]

• Updated dependencies [50a52fd]

• Updated dependencies [c2ad837]

• Updated dependencies [2a3e3e7]

• Updated dependencies [a3b67ae]

• Updated dependencies [1a36469]

• Updated dependencies [799174f]

• Updated dependencies [98f439c]

• Updated dependencies [6ec3241]

• Updated dependencies [148278c]

• Updated dependencies [c7f03e5]

• Updated dependencies [3644e1c]

• Updated dependencies [919fe97]

• Updated dependencies [cb24790]

• Updated dependencies [47b125d]

• Updated dependencies [982862f]

• Updated dependencies [a8c2196]

• Updated dependencies [ba30c6c]

• Updated dependencies [0b5cc9d]

• Updated dependencies [5a63701]

• Updated dependencies [60ec68c]

• Updated dependencies [d7d8a3e]

• Updated dependencies [fe5061b]

• Updated dependencies [2872606]

• Updated dependencies [a52a869]

• Updated dependencies [6ec3241]

• Updated dependencies [1a634cd]

• Updated dependencies [63ca28b]

• Updated dependencies [ad108ff]

• Updated dependencies [ad4823d]

• Updated dependencies [4f0f6b2]

• Updated dependencies [1f3e7cd]

• Updated dependencies [ab07609]

• Updated dependencies [2f3be33]

• Updated dependencies [90c129e]

• Updated dependencies [f71e660]

• Updated dependencies [150184b]

• Updated dependencies [66cce1d]

• Updated dependencies [c74ae90]

• Updated dependencies [7615b62]

• Updated dependencies [6070b02]

• Updated dependencies [7bb18e3]

• Updated dependencies [b9f88e3]

• Updated dependencies [8efbb45]

• Updated dependencies [6f4c83a]

• Updated dependencies [d8a406b]

• Updated dependencies [9f55bd1]

• Updated dependencies [4e55c06]

• Updated dependencies [128e195]

• Updated dependencies [8bce16d]

• Updated dependencies [ccaf3d4]

• Updated dependencies [3043826]

• Updated dependencies [2630461]

• Updated dependencies [576cb6f]

• Updated dependencies [217f708]

• Updated dependencies [57bc0e2]

• Updated dependencies [ca51306]

• Updated dependencies [f662237]

• Updated dependencies [3c6193d]

• Updated dependencies [1f3e7cd]

• Updated dependencies [198dbcc]

• Updated dependencies [363b85f]

• Updated dependencies [fef635e]

• Updated dependencies [6070b02]

• Updated dependencies [237c345]

• Updated dependencies [191e6c4]

• Updated dependencies [440ff42]

• Updated dependencies [7faa096]

• Updated dependencies [9099c35]

• Updated dependencies [98f439c]

• Updated dependencies [a95e745]

• Updated dependencies [80e11e0]

• Updated dependencies [c7f03e5]

  • [email protected]

v3.0.0-alpha.42

Compare Source

Patch Changes

• ca51306: Enhance focus ring style consistency.

v3.0.0-alpha.41

Compare Source

Patch Changes

• 237c345: Make React 18 as minimal requirement

v3.0.0-alpha.40

Compare Source

Patch Changes

• 982862f: Support for h2 and h4 Markdown headings with the Steps component.

v3.0.0-alpha.39

Compare Source

Major Changes

• 47b125d: fix global style conflicts for
  <a>/<button>/<summary>/<input>/[tabindex]:not([tabindex='-1']

• ba30c6c: use render props for className with selected, disabled and
  hover state for <Tab>

• 2872606: remove image prop from <Card> component, image will be showed
  based on truthiness children prop now

  set icon as optional prop

v3.0.0-alpha.38

Compare Source

Patch Changes

• ccaf3d4: Add the autoImportThemeStyle option to the Nextra configuration.
  This allows users to import the official Nextra theme CSS into a specific
  cascade layer.

v3.0.0-alpha.37

Compare Source

Patch Changes

• 2a3e3e7: Fix first list item in <FileTree> not within permitted parent
  elements

• 829c417: - fix overflow when clicking on <details> with open state

  • fix animation on mobile when clicking on <details> with open state

• Updated dependencies [2a3e3e7]

  • [email protected]

v3.0.0-alpha.36

Compare Source

Patch Changes

• 2b9b95b: migrate to @headlessui/react v2

v3.0.0-alpha.35

Compare Source

Patch Changes

• f662237: avoid focus-visible style being cut off by overflow-hidden

v3.0.0-alpha.34

Compare Source

Patch Changes

• 1a634cd: remove explicit ZodError assertion

v3.0.0-alpha.33

Compare Source

Patch Changes

• 7bb18e3: Add a generic for themeConfig in NextraThemeLayoutProps to
  improve type inference.

v3.0.0-alpha.32

Compare Source

Patch Changes

• 73239c4: To ensure consistent horizontal padding, set the default language as
  plaintext for code blocks. This prevents any loss of formatting for code
  blocks without a specified language.

• 799174f: fixed creating pageMap items for folders with dots

  remove requirement of passing filePaths with .md/.mdx extensions for
  createCatchAllMeta function

• 150184b: attach heading anchor id attribute to heading (like Pagefind do)
  and fix heading anchor styles when theme.typesetting: 'article' is set

• 3c6193d: Remove unnecessary sortPages from server/utils.ts

v3.0.0-alpha.31

Compare Source

Patch Changes

• d1e3e9a: handle case when meta object was added in transformPageMap

v3.0.0-alpha.30

Compare Source

Patch Changes

• 7615b62: fix useRouter in nextra/hooks, use asPath instead route
  because locale can be dynamic /[locale]

v3.0.0-alpha.29

Compare Source

Patch Changes

• fef635e: ignore loading pageMap for dynamic locale /[locale]

v3.0.0-alpha.28

Compare Source

Patch Changes

• a8c2196: use dynamic import for loading mermaid
• 363b85f: add flex-shrink: 0 for indent in FileTree for <Ident /> and svg
  icons in <Folder /> and <File />

v3.0.0-alpha.27

Compare Source

Patch Changes

• 4f0f6b2: Omit ...{:type} inline code annotations from search index #​2922
• a95e745: Fix the line highlighting background-color does not extend to the full width of the code block when a scrollbar appears with line numbers.

v3.0.0-alpha.26

Compare Source

Patch Changes

• 376b895: fixes case when setting disabled: true on the scroll to top button prevents scrolling to most top

  scroll to most top in toc element too

• 7b0b7e9: fix page scroll jump while entering characters in the search input

  • [email protected]

v3.0.0-alpha.25

Compare Source

Patch Changes

• de56507: fix vertical margin for nested ordered <ol /> and unordered
  <ul /> lists
  • [email protected]

v3.0.0-alpha.24

Compare Source

Patch Changes

• 6f4c83a: fix unclickable links in TOC

  allow passing recmaPlugins in mdxOptions

• Updated dependencies [6f4c83a]

  • [email protected]

v3.0.0-alpha.23

Compare Source

Minor Changes

• 6ec3241: Add Terraform/Move icon #​2811
  #​2808
• 6ec3241: Make the <Tab /> component be crawlable and indexable by search
  engines by default

Patch Changes

• ad108ff: use overflow-x-auto instead overflow-x-scroll for <Table />

• 217f708: update next-themes

  fix wrong numbering for nested <Steps />

v3.0.0-alpha.22

Compare Source

Patch Changes

• 2630461: fix
  TypeError: undefined is not iterable (cannot read property Symbol(Symbol.iterator))
  on dev environment when frontMatter.searchable: false

v3.0.0-alpha.21

Compare Source

Minor Changes

• 962cea6: allow items: Map for type: 'menu' since object can't guaranty
  the insertion order

Patch Changes

• [email protected]

v3.0.0-alpha.20

Compare Source

Minor Changes

• b776b16: add backgroundColor.light and backgroundColor.dark theme options

Patch Changes

• [email protected]

v3.0.0-alpha.19

Compare Source

Patch Changes

• d21634d: export getComponents
  • [email protected]

v3.0.0-alpha.18

Compare Source

Patch Changes

• Updated dependencies [98f439c]
• Updated dependencies [f71e660]
• Updated dependencies [98f439c]
  • [email protected]

v3.0.0-alpha.17

Compare Source

Minor Changes

• 3043826: add shikiji twoslash

  Demo feature:
  https://nextra-v2-na3obnhub-shuding1.vercel.app/docs/guide/twoslash-support

Patch Changes

• 9f55bd1: update rehype-pretty-code/shikiji to latest
• Updated dependencies [9f55bd1]
• Updated dependencies [3043826]
  • [email protected]

v3.0.0-alpha.16

Compare Source

Minor Changes

• 5a63701: add icons for following languages:

  • GraphQL (graphql)
  • C++ (c++, cpp)
  • C# (csharp, c#, cs)
  • Python (python, py)

  allow disallow mobile word wrap button in code blocks with word-wrap=false
  meta data setting

Patch Changes

• Updated dependencies [5a63701]
• Updated dependencies [90c129e]
  • [email protected]

v3.0.0-alpha.15

Compare Source

Patch Changes

• Updated dependencies [1a36469]
  • [email protected]

v3.0.0-alpha.14

Compare Source

Patch Changes

• 45471df: fix “Scroll to top” is not supposed to be interactable when it is
  hidden.

  display:children doesn't collapse breadcrumbs

  hide external links from pagination

  remove xmlns attribute from icons

  • [email protected]